home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Programming / Programming Tools / Sound / ErrDialog.c next >
Encoding:
C/C++ Source or Header  |  1986-08-10  |  4.2 KB  |  146 lines  |  [TEXT/ttxt]
  1. /***************************************************************************/
  2. /*                                                                         */
  3. /*                               ErrDialog.c                               */
  4. /*                                                                         */
  5. /*              Contains code for ErrDialog, OSError & ErrMessage          */
  6. /*                   For use when debugging application code               */
  7. /*                                                                         */
  8. /*              10/2/85   DJ Burnard                                       */
  9. /*                                                                         */
  10. /*              10/27/85 - DJB Put error strings into STR# resource        */
  11. /*              11/30/85 - DJB Changed to an Alert!                        */
  12. /*              05/03/86 - DJB Ported to MPW                               */
  13. /*                                                                         */
  14. /***************************************************************************/
  15.  
  16. /* include MPW C header files */
  17. #include <types.h>
  18. #include <strings.h>
  19. #include <memory.h>
  20. #include <quickdraw.h>
  21. #include <windows.h>
  22. #include <events.h>
  23. #include <dialogs.h>
  24. #include <resources.h>
  25.  
  26. /* #include <corrections.h> */
  27. /* #include <mystring.h>    */
  28.  
  29. #define    TRUE    1
  30. #define    FALSE    0
  31. #define    NIL          0
  32.  
  33. /* constant for error dialog kept in the resource fork*/
  34. #define errDialogID      9999
  35. #define errStringID      9999
  36. #define myLastErr        -120
  37. #define noErr                0
  38.  
  39.  
  40.       
  41. Str255  *Num2String(theNum, theStr)
  42.   long        theNum;
  43.   Str255   *theStr;
  44.   /* This is a minor variation on the Binary-Decimal Conversion
  45.      Package of the same name. Here we have made the procedure
  46.      into a function returning a pointer to the string. */
  47. {
  48.     NumToString(theNum, theStr);
  49.     return theStr;
  50. }
  51.  
  52. long   String2Num(theStr)
  53.   Str255   *theStr;
  54.   /* This is a minor variation on the Binary-Decimal Conversion
  55.      Package of the same name. Here we have made the procedure
  56.      into a function returning the long number. */
  57. {
  58.     long    theNum;
  59.     
  60.     StringToNum(theStr, &theNum);
  61.     return theNum;
  62. }
  63.  
  64.  
  65. /*
  66.  * ErrMessage:                          djb 10/27/85
  67.  *
  68.  *    Retrieve a message describing Mac OS Errors 
  69.  *    Expects the following parameters:
  70.  *
  71.  *      theOSErr - an OSErr - error code returned by OS routine
  72.  *
  73.  *    Message returned is in C format
  74.  */
  75.  
  76. char *ErrMessage(theOSErr, mesg)
  77.    OSErr   theOSErr;
  78.    char   *mesg;
  79. {
  80.    Str255   strtmp;
  81.    
  82.     if(theOSErr == noErr) {
  83.         strcpy(mesg, "noErr: False Alarm");
  84.     } else if(theOSErr > noErr) {
  85.         /* positive error code */
  86.         strcpy(mesg, Num2String(theOSErr, &strtmp));
  87.         strcat(mesg, " = Illegal Error Code > 0");
  88.     } else if((theOSErr < noErr) && (theOSErr > myLastErr)) {
  89.         /* get error message from STR# resource */
  90.         GetIndString(mesg, errStringID, -theOSErr);
  91.     } else {
  92.         /* an error code below the last one in STR# resource */
  93.         strcpy(mesg, Num2String(theOSErr, &strtmp));
  94.         strcat(mesg, ": Error not included in STR# resource");
  95.     }
  96.     return (mesg);
  97. }
  98.  
  99.  
  100. /*
  101.  * OSError:                          djb 10/02/85
  102.  *
  103.  *    display an error message for system errors. 
  104.  *    Expects the following parameters:
  105.  *
  106.  *      procName - C string (usually contains name of 
  107.  *                      routine where error occurred)
  108.  *      errNum   - error code returned by system (OSErr)
  109.  *      msg      - C string (arbitrary error message)
  110.  */
  111.  
  112. OSError(procName, errNum, msg)                              
  113.    char    *procName, *msg;
  114.    OSErr   errNum;
  115. {
  116.    Str255   errMsg, trapMsg;
  117.    
  118.    /* paste together trap message */
  119.    strcpy(&trapMsg, procName);
  120.    strcat(&trapMsg, " reports an error");
  121.    
  122.    ErrDialog(&trapMsg, ErrMessage(errNum, &errMsg), msg);
  123. }
  124.  
  125.  
  126. /*
  127.  * ErrDialog:                          djb 10/02/85
  128.  *
  129.  *    Alert programmer to an error situation 
  130.  *    Expects the following parameters:
  131.  *
  132.  *      str1, str2, str3 - C strings (arbitrary error messages 
  133.  *                           to the programmer)
  134.  */
  135.  
  136. ErrDialog(str1, str2, str3)
  137.     char   *str1;
  138.     char   *str2;
  139.     char   *str3;
  140. {
  141.     char          *err = "Programmer Error:";
  142.    
  143.     ParamText(err, str1, str2, str3);
  144.     StopAlert(errDialogID, NIL);
  145. }
  146.